home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / editor / a3e_121g.zip / A3E.DOC < prev    next >
Text File  |  1992-11-19  |  79KB  |  1,936 lines
  1.  
  2.                    Ansi Ascii Avatar Editor, A3E 1.21Γ    1992-11-19
  3.  
  4.                        (c) 1991 Jonas Högström
  5.  
  6.                            (2:204/408.3)
  7.                      (c91jonho@und.ida.liu.se)
  8.                                 for
  9.                          JH SoftService HB
  10.  
  11.                     Written in Turbo Pascal 5.5
  12.  
  13.  
  14.  
  15. This is the documentation for A3E. It is not the most extensive doc
  16. that has ever been written, but hopefully it will explain most
  17. features and the general idea of the program. If you think something
  18. is missing in the docs, please let me know, because as a programmer
  19. you (hopefully) know exactly what your program does, but you forget
  20. that the people who didn't write it might not.
  21.  
  22. This documentation is deliberately not pageformatted. If you want to
  23. print it, I'd recommend to use some printutility that inserts
  24. pagebreaks where necessary (for example TinyDoc from JHSoftService).
  25.  
  26. A couple of features in this programs will only be available to
  27. registered users, they will be marked with a (+) in the
  28. documentation.
  29.  
  30.  
  31.  
  32. LIST OF CONTENTS
  33.  
  34.      List of contents
  35.      Once upon a time
  36.      A word from the author
  37.      Registration
  38.      Distribution
  39.      Greetings and acknowledgements
  40.      Requirements
  41.      Multitasking
  42.      Disclaimer
  43.      Installation
  44.      The editor
  45.      Shortcuts
  46.      Defining fonts
  47.      Animations
  48.      Ansimusic & MusicEditor
  49.      The statusrow
  50.      The menusystem
  51.      Configuration
  52.      A3ECONF.EXE, The configuration easy-install utility.
  53.      BBSConfiguration
  54.      Plans for future versions
  55.      Official distributionsites
  56.      Registration form
  57.  
  58.  
  59. ONCE UPON A TIME
  60.  
  61. This program was once called USA (Ultimate Sysop Ansieditor), but
  62. since there was another program with the same name on the market
  63. already, I changed the name to A3E. To those of you who used this
  64. program under the old name I want to say: It's the same program,
  65. continue supporting it!
  66.  
  67. If you have a configuration file from the betaversions, you will be
  68. able to use it, just rename it to A3E.CFG.
  69.  
  70.  
  71.  
  72. A WORD FROM THE AUTHOR
  73.  
  74. Yep, it's me again. I just wanted to tell you why I wrote A3E: I had
  75. been using TheDraw for a while, and found it useful (I mean, who
  76. would even dream of making an ansifile in an ordinary texteditor),
  77. but it had some drawbacks in my opinion. The main thing was the
  78. file system; every time you wanted to save the file you were working
  79. on, you had to type the name, and if you wanted to save the file as
  80. both ascii and ansi you had to write it twice. Another thing, it had
  81. no support for automating the special codes for BBSprograms. So I
  82. decided something had to be done, I wrote my own Ansieditor. Some
  83. features might have a striking similarity to features in other
  84. programs, but all the coding, except from the ExecSwap and the
  85. .COM-file header was made by me myself (OK, a few basic routines was
  86. made by my brother and partner Jesper Högström).
  87.  
  88.  
  89.  
  90. REGISTRATION
  91.  
  92. I made this program because I felt there was a need for it, but that
  93. doesn't mean I want to give it away just like that. I've spent about
  94. PLENTY of hours making this program.
  95.  
  96. If you want to register this program, all you have to do is to fill
  97. out the registration form (at the end of the doc) and send it to the
  98. right place according to information below
  99.  
  100. via Snailmail, FIDO-NETmail or INTERNET (addess at end of doc).
  101. I also want you to send me some money:
  102.  
  103. Swedish Users:
  104.  
  105.    Registrationform can be sent any of the following ways:
  106.    Snailmail......: Jonas Högström,
  107.                     Kungsbergsgatan 8c,
  108.                     582 53 Linköping
  109.                     Sweden
  110.  
  111.    Fido NetMail...: 2:204/408.4 (route direct via my Boss)
  112.    Internet Email.: c91jonho@und.ida.liu.se
  113.  
  114.    Send the money via postal giro. At least 100 SEK to pg 6291111-0,
  115.    Jonas Högström.
  116.  
  117.    NOTE! The pg-number was wrong in the documentation in version 1.00
  118.    and earlier, but the above is the correct one, I promise.
  119.  
  120. North American Users:
  121.  
  122.    Send the money and the registrationform ($18) to the US-support &
  123.    registrationnode: Chris Patterson
  124.                      P.O. Box 1660
  125.                      Broken Arrow, OK 74013 1660
  126.                      USA
  127.  
  128.  
  129. Other Users:
  130.  
  131.    Send me the registrationform (according info to Swedish users).
  132.    Send the money ($18 or 100 SEK in cashmoney! (not cheque)) in the
  133.    same envelope, and put it all in a second envelope, so the
  134.    postman wont see it and take it.
  135.  
  136.  
  137. As soon as possible you will receive your key in one of the
  138. following way:
  139. 1. By internet Email if you have that possibility.
  140. 2. By fidonet-fileattach if you have that possibility.
  141. 3. By snailmail (printed on a piece of paper)
  142.  
  143. If you get your key by snailmail, just type it into a texteditor (or
  144. A3E and save it as Ascii, without Clear screen) and name it A3E.KEY
  145.  
  146. A registration key may not be used by two computers at the same time.
  147. If you are going to use A3E in a network environement, you have to
  148. have one key-file for each computer that will be likely to use it.
  149. This does not apply for sysops that have several computers in a
  150. network for the same multinode BBS.
  151. If you want to order a large amount (10+) of keyfiles, call me and
  152. we'll discuss a discount.
  153.  
  154.  
  155. Just to give you few reasons to register A3E (apart from the idea of
  156. the shareware concept), read the following statements:
  157.  
  158. * The maximal number of BBSCodes will increase from 15 to 140.
  159.  
  160. * All the configuration-parameters will be fully working.
  161.  
  162. * The box that pops up when you start A3E will be gone (and the beep
  163.   as well)
  164.  
  165. * the registration key will be valid for all future versions of A3E
  166.   (unless something really unexpected happens, like I loose all my
  167.   sourcecode, and have to start all over again)
  168.  
  169. * Registered users may save and load macros (and they will NOT
  170.   selfdestruct).
  171.  
  172. * Registered users may save screens that includes stuff from the
  173.   font feature.
  174.  
  175. * Registered users don't get the tagline at the bottom of
  176.   animations.
  177.  
  178. * Registered users can always run the latest betaversion. You have
  179.   to get hold of it yourself, and you run it on your own risc. See
  180.   distributionsites for further info.
  181.  
  182.  
  183. A BIG thanx to those of you guys who have already registered A3E!
  184.  
  185.  
  186.  
  187.  
  188. DISTRIBUTION
  189.  
  190. A3E may bee freely distributed by anyone, as long as the following
  191. rules are kept:
  192.  
  193. * Nothing is modified, added or deleted in the original files.
  194.  
  195. * No fee is charged for distribution (sysops may take a fee for the
  196.   BBS itself, but not a special fee for A3E).
  197.  
  198. * Shareware distributors may not make profit of A3E unless they have
  199.   a written permission from me (I would like a part of the profit).
  200.  
  201. * Registration keys may not be distributed AT ALL, by ANYONE (except
  202.   me of course).
  203.  
  204.  
  205.  
  206. DISCLAIMER
  207.  
  208. A lot of actions have been taken to prevent any harmful bugs in this
  209. peice of software, however, I will take NO responsibility if it
  210. happens to mess anything up, reformat your HD, burn your CPU, wreck
  211. your CD-player, kill your mother or anything else that happens due
  212. to use or non use of this program. You are on your own now, kid...
  213.  
  214. I strongly suggest you start off by backing up any important /
  215. nonimportant files that will get in touch with A3E every now and
  216. then (btw, backing up your files once in a while always makes
  217. sense).
  218.  
  219. The only thing guaranteed is that it will occupy a bit of diskspace
  220. on your HD...
  221.  
  222. I know that the directory system has a peculiar way of working. But
  223. if you always use the "point and shoot selection box" to change
  224. directorys it will work just fine (don't enter a new path and a
  225. filemask at the same time, thats the thing that doesn't work I
  226. think). I will take a look at this sometime, but it's really weird
  227. code...
  228.  
  229. When trying to load files with the readonly attribute A3E will say
  230. that they do not exist. This will be adressed in a later version,
  231. but in the meantime, please remove the readonly attribute (with NC
  232. or PCtools or some shareware-product).
  233.  
  234.  
  235.  
  236. GREETINGS AND ACKNOWLEDGEMENTS
  237.  
  238. First of all I'd like to thank ANSI for the standard (not that it is
  239. very good, but atleast it is a standard). And to all sysops who run
  240. BBSes out there, keep up the good work. I'd also like to thank the
  241. people that have helped me with ideas or in any other way made life
  242. easier while working with A3E:
  243.  
  244. Jesper Högström, for teaching me pascal (a long time ago) and for
  245.    having developed some of the lowlevel routines in A3E (he's my
  246.    brother so it is not to be regarded as theft). Also for some
  247.    betatesting of the program. Needless to mention, he's a helluva
  248.    guy!
  249.  
  250. Anders Ivner, for lots of ideas (paintmode, blockblend and the
  251.    line-algorithms for the generic blocks for example), and plenty
  252.    of comments on the docs (my spelling is lousy).
  253.  
  254. Jan Boström, my fidohub, for distributing the betaecho and betafile
  255.    echo, and never being busy. He also gave me a bugreport on the
  256.    file-handling system.
  257.  
  258. Paul Leffler, Betatester, plenty of ideas, for example the Attribute
  259.    function (ALT-A), Shortcuts in the menu, polygon/circle blocks,
  260.    corrected spelling errors... and a lot more. Keep up the good
  261.    work Paul :-)
  262.  
  263. Jonny Bergdahl, Betatester, for example the path in the directory
  264.    frame.
  265.  
  266. Fredrik Lewerth, Betatester, father of Extralines, and for reporting
  267.    a BIG bug in Avatar.
  268.  
  269. Joel Rosdahl, Betatester, for a nice list of bugs and proposals of
  270.    features (ex ATKeypad, adjust block, Adapt in draw, configuration
  271.    controll). Also for drawing the logo that is displayed in the
  272.    beginning and end (drawn with A3E, using a lot of paint, draw,
  273.    blend and stuff).
  274.  
  275. HP Anvin, clever guy, for Linekey, a TSR with the same configuration
  276.    of the numeric keypad as A3E.
  277.  
  278. Per Brax, a sysop, called one day to say that A3E didn't restore his
  279.    screensize when he returned to DOS. A big thanks goes to this guy
  280.    for reading through the documentation and correcting all the
  281.    spelling errors and typos.
  282.  
  283. Jacob Österling, an good old friend, for the extremely short header
  284.    to the .COM-files (only 25 bytes), and for always helping me out
  285.    when I needed it.
  286.  
  287. Jimi Laursen, for pointing out that my swaproutines was a little
  288.    buggy.
  289.  
  290. My other betatesters, as soon as they (you?) report a bug or give me
  291.    an idea for a feature, they will be mentioned by name.
  292.  
  293.  
  294. A couple of products are mentioned in this documentation and here is
  295. where they come from.
  296.  
  297.  
  298. AnsiPaint       is (c) Drew Olbrich
  299. DESQView        is (c) Quarterdeck
  300. MS DOS          is (c) Microsoft Corp.
  301. Remote Access   is (c) Andrew Milner
  302. Thedraw         is (c) TheSoft Programming Services and Ian E. Davis
  303. Turbo Pascal    is (c) Borland International
  304. WildCat         is (c) Mustang Software
  305.  
  306.  
  307.  
  308. The ExecSwap routine I use comes from: Doctor Dobb's Journal, April 1989
  309. and was typed by: Svend Broholm
  310.  
  311. Avatar is the result of a cooperation between George A. Stanislav and
  312. Wynn Wagner III and is specified in the FSC0025  and FSC0037
  313. documents.
  314.  
  315.  
  316.  
  317. REQUIREMENTS
  318.  
  319. To run A3E you will need the following:
  320.    * A PC compatible computer with preferably 640 kb (never tried any
  321.      less)
  322.    * A graphic card that handles color (CGA/EGA/VGA) or B/W VGA, but
  323.      NOT Hercules.
  324.    * MSDos 3.30 or higher (if you haven't, take this advice
  325.      seriously: GET IT!).
  326.    * Some ansieditors require that you load
  327.      the ANSI.SYS driver (or compatible), but A3E does NOT!
  328.    * You don't have to be a wizzard (it helps, but is not required)
  329.  
  330.  
  331.  
  332.  
  333. MULTITASKING
  334.  
  335. If you want to run under a multitasking system, like for example
  336. DESQView, carefully make sure that your multitasker is fully aware
  337. of the fact that A3E will make direct writes to the screen. I've
  338. tried A3E under DESQview with good results, but be careful, it is
  339. easy to get things messed up if you have the wrong setup. This will
  340. show as "bleeding through" (the A3E window bleeds through to the
  341. other window), however, there will be no harmfull effects.
  342.  
  343. A3E has also been reported to work under windows (3.0/3.1) with good
  344. results, even in graphic-mode (you can put A3E up in a 10cm * 10cm
  345. window :-). 2 icons have been included in the archive.
  346.  
  347. Never start 2 copies of A3E at the same time however, as they share
  348. the same config file and swapfile.
  349.  
  350. A3E has successfully been installed under OS2, running both FAT and
  351. HPFS, so just keep trying if it doesnt want to work for you ;-)
  352.  
  353.  
  354.  
  355.  
  356.  
  357. INSTALLATION
  358.  
  359. To install A3E, Make sure that atleast the following files are in
  360. the same directory (either on your HD or on a diskette):
  361.  
  362.      A3E.EXE
  363.      A3E.CFG
  364.      A3EINTRO.BIN
  365.      A3E.KEY (if you are registered).
  366.      A3E.HLP
  367.  
  368. If you want to use a BBSconfig you must also put that file in the same
  369. directory. Also you should copy the *.FNT files to your A3E
  370. directory, otherwise, they will not be loadable.
  371.  
  372. If you want to make it easier to start, put the directory name in the
  373. path-statement in your AUTOEXEC.BAT.
  374.  
  375. Once there, you just start by typing the name of the exefile, and
  376. optionally followed by the name of an ansi, ascii or avatar file (on
  377. the same row, before pressing Enter).
  378.  
  379. It is as simple as that.
  380.  
  381. A3E will create some files in the directory where you have A3E.EXE:
  382.  
  383. A3E.BLK     - If you save a block
  384. A3E.PCK     - The picklist (+)
  385. A3E.DAT     - A faster internal form of you A3E.CFG for faster
  386.               loading. Do NOT edit this one, it will only cause you
  387.               problem. Always edit the A3E.CFG!
  388. A3E.MCR     - Contains macros. (+)
  389. A3E*.ICO    - Icons to use with MS-Windows
  390. *.FNT       - Fontfiles... (included in the archive Fonts.ZIP)
  391.  
  392.  
  393.  
  394.  
  395. THE EDITOR
  396.  
  397. The editor screen in general is like any other editor, you can walk
  398. around with your cursorkeys (including home/C-home/end/C-end/C-left/
  399. C-right/PgUp/PgDn/tab/Backspace/delete/Enter) and write your text
  400. (Wordwrap is not included!), but you can also change colors, draw
  401. boxes, copy/move/scroll/delete areas, draw lines and many other
  402. things.
  403.  
  404. Most features can be reached from the menu-system (you can reach the
  405. menusystem with a light touch on your F10) but there are also
  406. shortcuts to most features. Every feature is explained either in the
  407. section about menues or the section about shortcuts.
  408.  
  409. There is a built in screenblanker that will blank the screen after 5
  410. minutes (default, but configurable), just press any key and you are
  411. back in the editor again.
  412.  
  413.  
  414.  
  415.  
  416. SHORTCUTS
  417.  
  418. ALT - A    Attribute change. A screen containing all combinations of
  419.            foreground and background colors will appear, and a box
  420.            around the one you currently use. Move the box around
  421.            with your cursorkeys until you find a nice mix of color
  422.            and press Return. "B" will toggle foreground blink
  423.            (indicated with a blinking box).
  424.  
  425. ALT - B    Backgroundcolor. Lets you choose the color to use as a
  426.            background. Use your cursor to move the indicator to the
  427.            desired color.
  428.  
  429. ALT - C    Centerline. Simply adjusts the line with the cursor on
  430.            according with the edges of the screen.
  431.  
  432. ALT - D    Drawmode. This mode makes it possible for you to draw
  433.            continous lines (with the asciichars 179 - 218) on the
  434.            screen. You can choose between  ┼  ╬  ╫  and  ╪  kind of
  435.            lines. Just move the cursor around and see what happens.
  436.            When you are ready, just press CR. If your current
  437.            characterset is one with linecharacters, this will be
  438.            default in drawmode. One exception is if the "AdaptInDraw"
  439.            switch is active, and the character under the cursor is a
  440.            linecharacter, then the characterset containing that very
  441.            character will be used as default.
  442.  
  443. ALT - E    Exchange attributes. This feature will find every
  444.            position on the screen that has the same attributes as
  445.            the character under the cursor, and change them to the
  446.            current attributes. Handy if you changed your mind about
  447.            some mix of color.
  448.  
  449. ALT - F    Foreground. Sets the current foregroundcolor, pressing B
  450.            will toggle blink in your foreground. Use your cursor to
  451.            move the indicator to the wanted color.
  452.  
  453. ALT - G    Get color. Sets the current color to the one under the
  454.            cursor.
  455.  
  456. ALT - H    Online Help. Gives you a list of all the shortcuts. The
  457.            text displayed in the helpfile is contained in A3E.HLP.
  458.            Use either cursor keys or page up/page down to change
  459.            page. This routine is the routine that has been used for
  460.            all helppages, so I guess you find out your self how to
  461.            use the others.
  462.  
  463. ALT - I    Insert Line. Inserts a line between the current line and
  464.            the one above.
  465.  
  466. ALT - J    Jump between pages. You can have up to 8 pages (see the
  467.            configuration section) at the same time in your memory.
  468.            Each page has it's own filename and can be loaded and
  469.            saved without interfering with the other pages. Use ALT -
  470.            J to switch between the pages, you will be prompted for
  471.            which number to jump to.
  472.  
  473.            NB! there can only be one animation in memory at the same
  474.            time, therefor any animation that was designed will be
  475.            removed when you load a new file in another page.
  476.  
  477. ALT - K    Block commands. First you have to mark a block, the
  478.            following options are available:
  479.  
  480.            [B]egin   Sets one of the corners in your block. It
  481.                      doesn't have to be in any special order, and you
  482.                      can set the first corner again by pressing B if
  483.                      you change your mind.
  484.  
  485.            [E]nd     Sets the corner opposite to the first corner,
  486.                      marks the block, and takes you to the
  487.                      blockfeaturemenu.
  488.  
  489.            [R]ead    Reads a block saved in the file A3E.BLK.
  490.  
  491.            [L]ast    This option will retrieve the blockcoordinates
  492.                      you used for your last block. If this is your
  493.                      first block the [L] option will not be
  494.                      available.
  495.  
  496.            [C]ircle  The Circle and Polygon features enables you to
  497.            [P]olygon mark blocks that are not rectangular. They will
  498.                      work just as ordinay blocks, with the exceptoin
  499.                      that you can not "Adjust", "Mirror" or "Scroll"
  500.                      them.
  501.                      To mark a Circle, first specify the center by
  502.                      pressing "B" (begin), then move the cursor to
  503.                      specify height and width, and press "E" (end).
  504.                      To mark a Polygon you mark each corner with a
  505.                      Space, and the final corner with a RETURN. If
  506.                      the last position is not the same as the first
  507.                      position, an extra line will be drawn between
  508.                      the coordinates of the last corner and the
  509.                      first corner. If the lines of the polygon
  510.                      crosses each other, it is possible to get a
  511.                      block that has areas within it that are not
  512.                      marked.
  513.  
  514.            Move around the screen with your cursor keys and Home/End/
  515.            PgUp/PgDn until you are done. The colors in your block
  516.            will invert to show you easier what is marked and what is
  517.            not.
  518.  
  519.            Pressing space will have the same meaning as B the first
  520.            time and as E the second, you can in other words mark the
  521.            block with two subsequent spaces in the opposite corners.
  522.  
  523.            When your block is marked, a menu will appear on the left
  524.            side of the screen:
  525.  
  526.            Move     Move your block to another place on the screen,
  527.                     the default color will replace the area where
  528.                     the block used to be. You can also do stamps
  529.                     (leave a copy of the block) before you finally
  530.                     put it where it is supposed to be. There is a
  531.                     fast way to move the block to the sides: Left -
  532.                     Home, Right - End, Up - PgUp, Down - PgDn
  533.  
  534.            Copy     Just like move but the original will stay and
  535.                     you can put a copy of your block somewhere on
  536.                     the screen.
  537.  
  538.            Delete   Removes your block and puts the default
  539.                     background color there instead.
  540.  
  541.            Scroll   Simply lets you scroll the block inside itself.
  542.                     Try it and see what happens. Does not work on
  543.                     Circles and Polygons.
  544.  
  545.            Write    Writes your block to a file called A3E.BLK. This
  546.                     block kan be loaded via ALT-K R. This verison
  547.                     will only handle one block, but in future
  548.                     versions you'll be able to give them names and
  549.                     have several blocks at once (for saving logos,
  550.                     nice ansiparts or whatever).
  551.  
  552.            Blend    Let me introduce you to something you've never
  553.                     seen before in the world of ansi. An automated
  554.                     feature to blend (mix) colors! Every character
  555.                     in your block will be calculated together with
  556.                     it's closest neighbours, and a mediumcolor will
  557.                     be given to each character. It will look weird
  558.                     if you do this in a block of text but if you
  559.                     have an area containing the asciicharacters
  560.                     176..178, 219 and space (░▒▓█ ) then it will
  561.                     look marvellous, try it. As the result often
  562.                     improves with repeated blendings, you can choose
  563.                     how many passes to perform (so you won't have to
  564.                     mark the block every time), somewhere between
  565.                     3-5 is reasonable.
  566.                     If you want to see an example of the
  567.                     possibilities of this blend feature, check the
  568.                     '3' in the logo that is displayed when you load
  569.                     and exit A3E.
  570.  
  571.            Exchange attr     This works just like the global
  572.                     Exchange feature, but you will have to specify
  573.                     the colors once again. First you have to use
  574.                     your cursorkeys top move to a character with the
  575.                     attribute that you want to exchange (then press
  576.                     enter). To specify which color to change to,
  577.                     just pick the right one from the array that is
  578.                     displayed (works just like the attributeupdate).
  579.  
  580.            Exchange char     First specify the character that you
  581.                     want to replace, and then the character you want
  582.                     instead.
  583.  
  584.  
  585.            Fill     Will fill your block with Attribute, character,
  586.                     both, foreground or background. You will be
  587.                     prompted for character and color (or rather
  588.                     thoose necessary).
  589.  
  590.            Adjust   Prompts you to choose Right, left or center
  591.                     adjustment of the block. Does not work on
  592.                     Circles and Polygons.
  593.  
  594.            mIrror   You can flip the block horizontally, vertically
  595.                     or both. Does not work on Circles and Polygons.
  596.  
  597.            Up/lo case You can either turn every alpha-character into
  598.                     either upper or lower case, or you can turn
  599.                     every upper to lower and lower to upper (invert)
  600.  
  601.            Intensity Turn the intensity-bit on or off in the whole
  602.                     block.
  603.  
  604.            bOx      This is just like the Alt-O option, but it might
  605.                     be handy to reach from the block-menu as well.
  606.                     Draws a box around your block in the current
  607.                     linestyle.
  608.  
  609.            fonT     This is a big thing. Refer to the special
  610.                     sections on fonts.
  611.  
  612.            sHade    Puts a shade on either the right or the left of
  613.                     your block, you may choose the attribute.
  614.  
  615.            View     If you want a short peek in the screen before
  616.                     executing another blockcommand.
  617.  
  618.            For Move, Copy and Read The following options are
  619.            available:
  620.  
  621.            [U]nder  With the Under-option, your block will move
  622.                     around "under" the rest of the screen, and not
  623.                     cover it.
  624.  
  625.            [T]ransparent means that a space with the default
  626.                     background will look like glass. For example,
  627.                     you have a round shape that you want to move
  628.                     around, but the block is square, turn
  629.                     transparent on and you can see the original
  630.                     screen through the block in the corners.
  631.  
  632.                     The combination of Under and Transparent is
  633.                     perhaps a bit odd, and not completely logical,
  634.                     you move your block under the original screen,
  635.                     but the backgroundcolors from the block will
  636.                     shine through. If it looks weird, just turn
  637.                     Transparent off.
  638.  
  639.                     Solid spaces (Shift space) will override the
  640.                     transparent and under features.
  641.  
  642.            [J]ump   You can switch pages and still bring your block
  643.                     along. The Undo will reset when you arrive at
  644.                     the new page so if you choose [M]ove, switch
  645.                     pages and then change your mind, the original
  646.                     block will not be put back in the original page,
  647.                     but rather disappear into smoke.
  648.  
  649.            To have blockmode on ALT K is mainly an old WordStar-
  650.            convention, but I find it quite all right.
  651.  
  652.            The blockmenu will be active until you press either Space
  653.            to quit or ESC to undo.
  654.  
  655. ALT - L    Left adjust line. Moves the line with the cursor on as far
  656.            to the left as it will go.
  657.  
  658. ALT - M    Menu Toggle. You can switch the top row between displaying
  659.            the menu at all times or to display the current charset
  660.            (with associated numerical key), when not in the menu.
  661.  
  662. ALT - N (+)Font Mode. First you must define or load a font (otherwise
  663.            nothing exciting will happen). In font mode, you may type
  664.            any of the characters that are defined in the font, and
  665.            they will be displayed on the screen. The baseline will
  666.            be the line with the cursor and the cursor will move to
  667.            the next characterposition. If you press return the
  668.            cursor will move to column 1 and move as many lines down
  669.            as specified by the vertical margin of the font.
  670.            Backspace will only work with the 5 latest characters.
  671.            Exit font mode with CTRL-ENTER, or abort with ESC.
  672.  
  673.            Unregistered users may use the fontmode for evaluation
  674.            purposes only. Once they have entered the fontmode the
  675.            global savefile-function will be disabled. However, they
  676.            may load, save and edit fonts unlimited.
  677.  
  678. ALT - O    Outline, Makes a frame in the current linestyle, you mark
  679.            the box in the same way you mark a block (see ALT - K).
  680.  
  681. ALT - P    Paint mode. Works kind of like draw mode, but this one
  682.            just modifies the color attribute of the charachter.
  683.            The following features are available from paintmode:
  684.            P       toggles continuous painting (everywhere you go will
  685.                    be painted
  686.            C       Toggles Painting with character
  687.            F       Toggles painting of foreground color
  688.            B       Toggles painting of background color
  689.            H       Toggles painting in hi intensity.
  690.            L       Toggles painting in low intensity.
  691.            SPACE   Paints just the character under the cursor
  692.            ALT - C Change the character to paint with (indicated
  693.                    next to "COLOR" on the statusrow.
  694.  
  695. ALT - Q    Ruler, Makes it easier to put things in a straight line
  696.            across the screen. By pressung U in ruler mode, the ruler
  697.            will move under the text instead of covering it, Press U
  698.            again to return to normal mode.
  699.            Sorry 'bout the bad connection Q-Ruler, but the other
  700.            shortcuts were kind of busy.
  701.  
  702. ALT - R    Right adjust, just like left adjust, but the other way
  703.            around.
  704.  
  705. ALT - S    This routine (one of a kind!) will be able to recognize
  706.            the special BBScodes a sysop needs, it will also be able
  707.            to produce the same ones. If you place your cursor on the
  708.            first char in a BBScode the name of the code will be
  709.            displayed on the statusrow. If no code can be recognized
  710.            a list of those known to the program (via configuration
  711.            files) will be displayed and you can choose which one to
  712.            put on your screen. (More details about configuration,
  713.            see the BBSCodeConfig part.) Note that unregistered users
  714.            may only have 15 codes in memory, while registered may
  715.            have 140.
  716.  
  717. ALT - T    Tab adjust. Lets you change the distance between
  718.            tab-marks.
  719.  
  720. ALT - U    Unfurl BBSCodes. All BBSCodes that have a specified
  721.            length (see BBSCodeConfig) will be expanded to a string
  722.            of respective length, containing 'X'es. This is meant to
  723.            make it easy to look at what your screen will look like
  724.            when displayed to your Users. If you have codes that will
  725.            be expanded to a line-length exceedeing the screen width,
  726.            a beep will sound, and that string will have inverted
  727.            colors to make it easy to detect.
  728.  
  729. ALT - V    Border fill. If you want to fill the area inside a frame
  730.            with the same character, attribute or both, just press
  731.            ALT - V and choose what to fill with (color will always
  732.            be the current). The characters in Charset 1-5 will be
  733.            considered as frames.
  734.  
  735. ALT - W    Scroll the whole screen (Wrap). Use your cursorkeys to
  736.            move it around. What goes out to the right comes in on
  737.            the left... (what goes out the drain is forever lost :-)
  738.  
  739. ALT - X    Quit. If you have made changes since last save you will
  740.            be prompted for another save.
  741.  
  742. ALT - Y    Delete line. Deletes the line with the cursor. The line
  743.            will be stored in a small buffer to be used with the
  744.            "Undelete line"-feature
  745.  
  746. ALT-CTRL-Y UnDelete line. This will insert the last line that was
  747.            deleted at the cursorposition.
  748.            
  749. ALT - Z    OSshell. Will open a shell to your OS if there is enough
  750.            memory for it. Just type Exit while in OS to return to
  751.            A3E.
  752.  
  753.            NOTE! Be careful about loading any memory-resident
  754.            programs (TSR) while in OSshell. It might work this time,
  755.            or it might not work at all. You may get systemcrashes or
  756.            unpredictable results.
  757.            An extra warning is not to start a new copy of A3E in a
  758.            OSshell, as this most likely will mess things up on your
  759.            HD.
  760.  
  761. ALT 0..9   Set charset. On the status row you can see a number of
  762.            characters, these are the ones that will be typed if you
  763.            press Numlock (just light the numlock-LED) and then use
  764.            either your numeric keypad or your normal numberkeys on
  765.            top of your keyboard. You can change the charactersets by
  766.            pressing ALT 0, 1, 2 .. 9.
  767.  
  768.            Here is a list of the different sets (will also be shown
  769.            when you change charset via the menu) :
  770.  
  771.              0      1 2 3 4 5 6 7 8 9 0 +     | Ex of how they will be
  772.              1      └ ┴ ┘ ├ ┼ ┤ ┌ ┬ ┐ ─ │     | mapped on the numeric
  773.              2      ╚ ╩ ╝ ╠ ╬ ╣ ╔ ╦ ╗ ═ ║     | keyboard:
  774.              3      ╙ ╨ ╜ ╟ ╫ ╢ ╓ ╥ ╖ ─ ║     |   ┌  ┬  ┐  │
  775.              4      ╘ ╧ ╛ ╞ ╪ ╡ ╒ ╤ ╕ ═ │     |            │
  776.              5      ▒ ▄ ▒ ▌ █ ▐ ▓ ▀ ▓ ░ ░     |   ├  ┼  ┤  │
  777.              6      α ß Γ π Σ σ µ τ Φ Ω Θ     |
  778.              7      δ ç Ç æ Æ ¢ £ ¥ ₧ ¿ ƒ     |   └  ┴  ┘
  779.              8      ∞ φ ε ∩ ≡ ≈ ± ≥ ≤ ⌡ ⌠     |
  780.              9      ÷ √ ° ⁿ ² ½ ¼ · ∙ ■ █     |   ────   really handy
  781.  
  782.            As you see ALT - 0 resets the keyboard to normal even
  783.            when numlock is on.
  784.  
  785. Numlock    Use charset. When the numlock-LED is lit the numeric
  786.            keypad and the ordinary numeric keys on top of the
  787.            keyboard will display the respective character from the
  788.            chosen charset.
  789.  
  790. Scrollock  Allcharsmode. When the scrollock-LED is lit you can
  791.            produce exactly any character on your keyboard. the
  792.            escape key will for example give you a '' and your
  793.            Enter key will give a chr(13), DeleteLine (CTRL-Y) and
  794.            Insertline (CTRL - I) will be disabled via shortcuts,
  795.            but reachable from the menu. The high chars (127..255)
  796.            that are not in any characterset can always be produced
  797.            by holding your ALT-key and typing the number of the
  798.            character on the numeric keypad.
  799.  
  800. CTRL - Y   Delete line, same as ALT - Y, but I put it here as well,
  801.            just because I'm used to finding it here myself.
  802.  
  803. CTRL - CR  Split line. Moves the rest of the line (right of the
  804.            cursor to a new inserted line just below.
  805.  
  806. ESC        UNDO. Pressing Esc will always undo the last major
  807.            command or mode you used and restore the screen to what
  808.            it looked like before. If you press Esc a second time, it
  809.            will restore the screen to what it looked like before the
  810.            first undo.
  811.  
  812. SHIFT - Esc Save Undo. Pressing SHIFT - Esc will reset the undoscreen
  813.            so that the next time you Undo anything it will at least
  814.            not go further back than the current state.
  815.  
  816. ALT        Menu. If you "tap" the ALT key without pressing any other
  817.            key meanwhile, this will be a handy shortcut to the menu.
  818.  
  819. LeftShift +
  820. RightShift Can be configured to work as a tap on ALT when pressed
  821.            both at the same time. In DESQView the ALTkey is a little
  822.            special and that interferes with A3E.
  823.  
  824. F1         OnLine Help, just as ALT - H
  825.  
  826. F2         Save. See menusystem, Filemenu
  827.  
  828. F3         Load. See menusystem, Filemenu
  829.  
  830. F5         Define animation. Further info in the section about
  831.            animations.
  832.  
  833. F6         View/record macros.
  834.  
  835. F7         Enter the AnsiMusic-editor (see further special
  836.            Music-chapter)
  837.  
  838. F9         Asciichart. An easy way to get a character with an odd
  839.            asciivalue. A chart containing every available asciicode
  840.            will be shown, and you may move around with your
  841.            cursorkeys to pick the one to use. To put it on the
  842.            screen you just press CR, and to abort you press ESC.
  843.  
  844. ALT - F3   Pick. See menusystem, Filemenu
  845.  
  846. ALT - F7   Insert Music-ID-String (see Music-chapter)
  847.  
  848. ALT - F9   Toggle screensize.
  849.  
  850. F10        Menu. Sends you to the topmenu.
  851.  
  852. CTRL F1-F10 Macro sequenses, further information, se macro-recording
  853.            in the modemenu. (+)
  854.  
  855. SH - BS    ClearScreen, keeps the filename. prompts first.
  856.  
  857. SH - Home  Moves to the first character on the line. If the line is
  858.            empty, it moves to column 1.
  859.  
  860. SH - End   Moves to column 80 of the current line.
  861.  
  862. SH - Space Solid Space, This is not an ordinary space. It looks like
  863.            a space on the screen, but it cannot be seen through. If
  864.            you for example move a block under a solid space, the
  865.            space will cover the block as if it were a character, It
  866.            will also cover the ruler. They will be saved and loaded
  867.            as solid spaces as well.
  868.            To be able to tell a solid space from a normal space, the
  869.            solid space will shimmer in different colors when you
  870.            position the cursor above. It will also indicate on the
  871.            statusrow with the number 255, instead of 32 like the
  872.            normal space.
  873.  
  874. CTRL - Space writes a space with default colors at the cursor
  875.            position.
  876.  
  877. Insert     Toggles insertmode. When Insert is on, your cursor will
  878.            be small, and when Insertmode is off, your cursor will be
  879.            large. Another thing is that with Insert OFF, the screen
  880.            won't be messed up by delete and backspace.
  881.  
  882. SH - Insert Inserts a space with current colors at the
  883.            cursor position.
  884.  
  885. SH-CAPS    Inverts the capsstatus of the character under the cursor.
  886.  
  887.  
  888.  
  889. DEFINING FONTS (+)
  890.  
  891. Start out by drawing a character on the screen (using any of the
  892. nice features in the editor), and mark the character as a block (as
  893. tight as possible to save memory). NOTE: A character may not be
  894. bigger than 16 lines high and 22 columns wide.
  895.  
  896. Choose the font-command in the blockmenu.
  897.  
  898. Choose the corresponding character with the cursorkeys; If you have
  899. marked an 'R' on the screen move the little red square to the letter
  900. 'R' in the upper part of the window that is displayed and press
  901. RETURN.
  902. Characters already defined are displayed in white in the upper part,
  903. the rest in gray, but you may place your character on any of these.)
  904.  
  905. Here comes a tricky part: now you have to decide where to have the
  906. baseline of the character (for normal capital letters it would
  907. usually be the lowest line, but for some lower case letters (for
  908. example 'p') it would be the line containg the lowest part of the
  909. bump of the 'p' (the line that is supposed to be on the same line as
  910. the lowest line of an 'A'). You may have to play around a bit with
  911. this until you get the hang of it but when you do it will show to be
  912. really handy.
  913.  
  914. Here is a small example on where to have the baseline for the
  915. characters "A" "B" "C" "p" and "g":
  916.  
  917.  
  918. XXXX XXXX XXXX
  919. X  X X  X X
  920. XXXX XXX  X    XXXX XXXX
  921. X  X X  X X    X  X X  X
  922. X  X XXXX XXXX XXXX XXXX    <<< baseline
  923.                X       X
  924.                X    XXXX
  925.  
  926.  
  927. Now the complete character is defined, and may be used in the
  928. Font mode.
  929.  
  930. To be able to use the font at a later time, you have to save it to
  931. disk. You will automatically be prompted for this if you have a
  932. modified prompt when you are about to load or dispose a font or when
  933. you are going to Quit A3E.
  934.  
  935.  
  936.  
  937.  
  938. ANIMATIONS (+)
  939.  
  940. The ansi and avatar formats have support to move around in the
  941. screen between writing characters. This makes it possible to display
  942. files in nonstandard (animated) ways (standard = top-down, each line
  943. written from the left to the right)
  944.  
  945. A3E supports animation to some extent, and here is how to make an
  946. animation:
  947.  
  948. First of all, load (or create) a file, then press F5 (this takes you
  949. into the animationdefinition mode).
  950.  
  951. The only part of the page that is "animateable" in A3E is the
  952. upper visible part of the page. If you have a CGA-monitor (or is in
  953. 25-line mode) you can only animate the top 23 rows, otherwise, you
  954. can animate 48 rows.
  955.  
  956. Now you can specify exactly in which order each character should
  957. appear on the screen when the file is displayed. There are several
  958. ways to mark characters as animated:
  959.  
  960.    SPACE : Marks the current character as animated
  961.    U     : Unmarks the current character
  962.    Block : If you define a block (with ALT-K) you can animate the
  963.            block in a bunch of predefined ways (a special menu will
  964.            be presented once you have marked the block).
  965.            If the block contains characters that are already marked,
  966.            these will just be ignored when the block is animated.
  967.            One of the animation blockmenu commands is to unmark the
  968.            marked area.
  969.    W     : This is only a special blockcommand that will mark the
  970.            whole screen and then enter the animation block-menu
  971.    SH+CUR: Pressing Shift and moving around with the cursorkeys will
  972.            mark every character you pass with the cursor. This can
  973.            also be used to unmark characters (toggle with the
  974.            insert-key, the current state is indicated on the
  975.            statusrow).
  976.    ALT-C : Clear any previous definition
  977.    R     : Reverses the complete animationsequence.
  978.  
  979. If you want to find a specific characterposition to unmark for
  980. example, you can press "S" (show) to see a copy of the original
  981. screen, where you may move around the cursor to the right place.
  982.  
  983. If you want to get a clue on how your animation will look, press "V"
  984. (view). The speed of "view" can be changed with the configuration
  985. command "ViewAnimationSlowDown"
  986.  
  987. There are a few different ways that a marked character is indicated,
  988. and you can change between these ways by pressing "1", "2" or "3".
  989. This feature could be used to see if every character is marked, as
  990. some of the ways are more obvious than others, but on the other hand
  991. they might give you a headache if you use it all the time.
  992.  
  993. When you have marked all the characters you want to mark, you press
  994. ENTER. The animationsequence is now stored in memory, and may be
  995. applied to any file when saved (see filemenu / save for further
  996. details).
  997.  
  998. You do not have to mark every character when designing an animation,
  999. but those not marked will not be saved into the animationfile.
  1000.  
  1001. REMEMBER! you can only have one animation in the memory at each
  1002. time, and if you load a new (animated) file in another page the
  1003. first animation will be lost.
  1004.  
  1005. If you are not registered, each animation you save will have an
  1006. extra line at the end, saying where the animation came from. Using
  1007. these files is NOT a violation of any copyright, but it might not
  1008. look very nice.
  1009.  
  1010.  
  1011.  
  1012.  
  1013. ANSIMUSIC & MUSICEDITOR
  1014.  
  1015. A3E supports loading, editing and saveing AnsiMusic.
  1016.  
  1017. Loading is the easiest part, just load a file containing Ansimusic
  1018. (and text/ansigraphics). The music will be extracted and stored in
  1019. the memory for later use.
  1020.  
  1021. This documentation will in no way discuss the theory of music,
  1022. tempo, harmony or anything like that... it is up to you to know or
  1023. find out.
  1024.  
  1025. To edit the loaded music, or to compose som e new music, start off
  1026. by pressing F7 (to enter the musiceditor). Now you have a notesystem
  1027. on the screen (and some notes if there is any music in memory). Also
  1028. you have a map of the keyboard to see what key corresponds to what
  1029. note.
  1030.  
  1031. By using the keys in the map, you add notes to your tune. Pressing
  1032. Space will insert a pause. Change pitch of the current note by
  1033. pressing Up/Down, and change length by pressing Shift+Up/Down. If
  1034. you want the note pointed (add an extra half to the length), you
  1035. toggle it with RETURN. Remove notes with Delete or BackSpace.
  1036. Move around in your tune with Left/Right/C-Left/CRight/Home/End.
  1037.  
  1038. To hear what it sounds like, either walk around with the cursorkeys,
  1039. or play F10 (that will play in realtime from current note).
  1040.  
  1041. If you want to have notes in very high or very low pitches, you can
  1042. change the octave of the keyboard with F5/F6.
  1043.  
  1044. When you are satisfied with your tune, return to the ansieditor with
  1045. ESC.
  1046.  
  1047. IF you want to save the music in a special place in your file, you
  1048. can insert a Music-ID-String (looks like »»MUSIC««) at the
  1049. cursorposition with ALT-F7, otherwise it will be saved at the end of
  1050. your file.
  1051.  
  1052. It is not possible to have two or more tunes at different locations
  1053. in the file and it is not possible to have two different tempos in
  1054. the same tune.
  1055.  
  1056. A3E does not support all of the AnsiMusic codes (since I dont have
  1057. any specifications), but those not supported will be ignored when
  1058. loading.
  1059.  
  1060. Right now, there are not that many other programs that support
  1061. ansimusic, but I know of one terminalprogram (terminate) and one
  1062. ansi-displayprogram (ansiplay) that does. Hopefully there will be
  1063. more.
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070. THE STATUS ROW
  1071.  
  1072. Here is a sample status row:
  1073.  
  1074. ---------------------------------------------------------------------------
  1075. X: 4 Y:21 P:1  *INSCX COLOR NONAME.SCR    #32           A3E vN.nn  15:12:39
  1076. ---------------------------------------------------------------------------
  1077. coords    Page flags  color filename      char          version    Time
  1078.  
  1079. Coords simply give you the coordinates of the cursor.
  1080.  
  1081. Page shows the number of the current page.
  1082.  
  1083. Flags indicate the following:
  1084.  
  1085.       *   The file has been modified since last save
  1086.       I   Insert is on
  1087.       N   Numlock is on, meaning you will get the current charset
  1088.           when pressing a numerical key
  1089.       S   Scrollock is on, meaning you will get a nice graphical
  1090.           character when pressing the ESC, Backspace, Enter or
  1091.           alphakeys together with CTRL
  1092.       C   Capslock is on, meaning... just in case your LED is
  1093.           malfunctioning :-)
  1094.       X   Indicates that you have the "invert_under_cursor"-feature
  1095.           enabled (X from the logical operator XOR)
  1096.  
  1097. Color is written in the current color (change it with ALT - F or
  1098. ALT - B if you don't like it).
  1099.  
  1100. Filename is the name of the current file without path.
  1101.  
  1102. Char shows the asciicode for the character under the cursor, if you
  1103. want a listing of all existing asciicodes, try your dos manual, or
  1104. some other reference manual (or just type every character you can
  1105. think of and look on the statusrow :-)
  1106.  
  1107. Version: N.nn indicates the current version of A3E.
  1108.  
  1109. Time, selfexplanatory :-)
  1110.  
  1111.  
  1112.  
  1113. THE MENUSYSTEM
  1114.  
  1115. The menusystem is easily reached by pressing F10 when you are in the
  1116. editor-mode (not reachable from paint/draw/font... mode). Once in
  1117. the menusystem you can choose from the topmenu and enter a submenu
  1118. (press CR). Once in a submenu you can choose a menuitem by moving
  1119. there with cursor up/down or go to another submenu with cursor
  1120. left/right. Most menu items are followed by a key-combination
  1121. representing the shortcut for the feature, others can only be
  1122. reached via the menu system. Here follows a presentation of the
  1123. menuitems (those explained in the Shortcut-list will not be
  1124. repeated, just referred to).
  1125.  
  1126. There is also an alternative way to make menuchoices, in both the
  1127. topmenu and the submenus. Every menuoption has one character
  1128. highlighted, and by pressing that character on the keyboard you will
  1129. choose that option. I've tried as far as possible to make this
  1130. menushortcut the same character as the normal shortcut, and for
  1131. those menuoptions that didn't have a normal shortcut I've tried to
  1132. choose it as logical as possible.
  1133.  
  1134.  
  1135.  
  1136. THE TOPMENU
  1137.  
  1138. -----------------------------------------------------------------
  1139.   FILE   COLORS   FRAME/FILL   SCREEN   MODES   FONT   HELP
  1140. -----------------------------------------------------------------
  1141.  
  1142. The topmenu can be replaced with a display of the current Charset
  1143. (toggle with ALT - M) when you are in normal editing mode, but will
  1144. always be there when you enter the menusystem. Every time you enter
  1145. the topmenu you will get to the submenu you last accessed
  1146.  
  1147. THE SUBMENUES
  1148.  
  1149. FILE MENU
  1150.    Load         If the current file has been changed, you will first
  1151.                 be prompted to save it.
  1152.                 Thereafter you will be prompted for a new filename
  1153.                 (you may also choose from a filelist) and the file
  1154.                 is loaded into the editor.
  1155.                 If the file is animated the sequence will be stored
  1156.                 in memory so it can be used when you save the file
  1157.                 again.
  1158.  
  1159.    Save         Will save your file to the formats specified in
  1160.                 "Write to". If filename is NONAME (default), or if
  1161.                 the file hasn't been saved before during this
  1162.                 session you will be prompted to confirm or change
  1163.                 the filename, and you will also get the possibility
  1164.                 to set which modes to save the file in (same
  1165.                 procedure as described in "Write to", later in this
  1166.                 document).
  1167.  
  1168.    Pick         Lets you load one of the most recent files into the
  1169.                 editor, and restore all the settings from last time
  1170.                 the file was edited (this does not regard
  1171.                 screensize).
  1172.                 (+) registered users have the possibility to save
  1173.                 the picklist to disk and automatically reload it
  1174.                 when they start A3E at a later time.
  1175.  
  1176.    New          Clears the screen and sets the filename to NONAME.
  1177.  
  1178.    Directory    Shows a directory from a specified path and
  1179.                 filemask. By pressing any letter you will move to
  1180.                 the first file/directory that starts with that
  1181.                 character. (F4 for a new mask) NB! Only the first
  1182.                 512 files in your directory will be shown, but that
  1183.                 should suffice in most cases.
  1184.  
  1185.                 If the extention in the filemask is .$$$, all files
  1186.                 matching the extentions for ansi, ascii and
  1187.                 avatarfiles will be shown.
  1188.  
  1189.    Write to     Change the path, name and extensions of your file.
  1190.                 You can also set which modes to save the file in
  1191.                 (Ansi/Ascii/Avatar/COM). Pressing the function-key
  1192.                 associated to each filemode will toggle save of that
  1193.                 specific filemode ON/OFF.
  1194.                 Set extralines to the number of empty lines to put
  1195.                 in the end of the file (does not apply to animations
  1196.                 and .COM-files).
  1197.                 Toggle Clearscreen with F9 (files will often get a
  1198.                 little smaller with clearscreen on, but it never
  1199.                 affects COM-files at all).
  1200.                 If you have an animation in memory when you are
  1201.                 going to save, you may apply it on the current file.
  1202.                 Toggle with F10. Animation will never affect ASCII-
  1203.                 or COM-files, these will always be saved as normal
  1204.                 files.
  1205.  
  1206.    Change dir   Change to new directory and make it the default
  1207.                 directory.
  1208.  
  1209.    LoadMode     Specify which mode to use when loading. Trying to
  1210.                 load an ansifile in avatarmode will surely mess up.
  1211.                 When loading a file the Automode will try to
  1212.                 determine the type of file it is, and this really
  1213.                 works well. I suggest you have this as your default.
  1214.                 The only time it will be incorrect is when you try
  1215.                 to load an asciifile that contains either an
  1216.                 ESC-character, ^V or ^Y as these are used to
  1217.                 recognize Ansi/Avatar. The loadmode will also
  1218.                 determine which filemode will get the original
  1219.                 extension.
  1220.  
  1221.    OS shell     See shortcutlist, ALT - Z
  1222.  
  1223.    Process #12  If you have a file that contains a chr(12) (female
  1224.                 sign / FormFeed) it would normally be processed as a
  1225.                 clearscreen if loaded as avatar and ascii (not
  1226.                 ansi), but if you want it to be loaded as a
  1227.                 femalesign, just turn the "process #12" OFF
  1228.  
  1229.    PrintFile    Gives an asciidump of your file straight to LPT1. It
  1230.                 will not be available if you are unregistered and
  1231.                 have used the fontfeature.
  1232.  
  1233.    Quit         Quits A3E. If current file is modified, you will be
  1234.                 prompted to save. Same as ALT - X.
  1235.  
  1236. COLOR MENU
  1237.    Foreground   See shortcutlist, ALT - F
  1238.  
  1239.    Background   See shortcutlist, ALT - B
  1240.  
  1241.    DefaultBack  lets you choose the background color that will be
  1242.                 used when you insert new lines or at the end of a
  1243.                 line where you press del.
  1244.  
  1245.    GetColor     See shortcutlist, ALT - G
  1246.  
  1247.    Attribute    See shortcutlist, ALT - A
  1248.  
  1249.  
  1250. FRAMEFILL MENU
  1251.    Framescreen  Puts a frame around the whole screen.
  1252.  
  1253.    Frametext    puts a frame surrounding the text on the screen.
  1254.  
  1255.    Frame        See shortcutlist, ALT - O
  1256.  
  1257.    Fillscreen   Fills the whole screen with a character, attribute
  1258.                 or both.
  1259.  
  1260.    Fillframe    See shortcutlist, ALT - V
  1261.  
  1262.  
  1263. SCREEN MENU
  1264.    DelLine      See shortcutlist, ALT - Y and CTRL - Y
  1265.  
  1266.    InsLine      See shortcutlist, ALT - I
  1267.  
  1268.    ClrScr       Clears the screen, keeps the filename. Prompts
  1269.                 first.
  1270.  
  1271.    CenterLine   See shortcutlist, ALT - C
  1272.  
  1273.    RightAdjust  See shortcutlist, ALT - R
  1274.  
  1275.    LeftAdjust   See shortcutlist, ALT - L
  1276.  
  1277.    Set Tabsize  See shortcutlist, ALT - T
  1278.  
  1279.    Set CharSet  See shortcutlist, ALT - 0..9
  1280.  
  1281.    ScreenSize   Sets the screensize to the chosen one (CGA handles
  1282.                 no more than 25 lines, it is useless to even try ).
  1283.                 If you have an EGA-adapter the later menu choice
  1284.                 will give you 43 lines, and if you have a
  1285.                 VGA-adapter or higher, you will get 50.
  1286.  
  1287.    ScrollScreen See shortcutlist, ALT - W
  1288.  
  1289. MODEMENU
  1290.    DrawMode     See shortcutlist, ALT - D
  1291.  
  1292.    AllChars     See shortcutlist, Scrollock
  1293.  
  1294.    InsertMode   See shortcutlist, Insert
  1295.  
  1296.    PaintMode    See shortcutlist, ALT - P
  1297.  
  1298.    BlockMode    See shortcutlist, ALT - K
  1299.  
  1300.    BBSCodes     See shortcutlist, ALT - S
  1301.  
  1302.    UNDO         See shortcutlist, ESC
  1303.  
  1304.    Save UNDO    See shortcutlist, SHIFT - ESC
  1305.  
  1306.    Show SolidSpaces All solid spaces (#255) will flicker until you
  1307.                 press a key. This is an easy way to detect unknown
  1308.                 solid spaces that mess up your blockmove, centerline
  1309.                 or something.
  1310.  
  1311.    Macro redording (+)
  1312.                 You can assign sequenses of keystrokes to a single
  1313.                 key. If you want to record a macro, just follow
  1314.                 these simple steps:
  1315.                 1. Press the Key to use (CTRL F1-CTRL F10).
  1316.  
  1317.                 2. Type the name of the macro (the macros will be
  1318.                    saved if you are registered and this will make it
  1319.                    possible to remember what the macro does even
  1320.                    after a long period of time).
  1321.  
  1322.                 3. Punch the keys that you want to have in the macro.
  1323.                    They will be shown on the screen but perhaps a
  1324.                    bit hard to understand. Normal characters will be
  1325.                    written in white along with some others. Most
  1326.                    controllkeys and cursorkeys will produce a cyan
  1327.                    colored letter (or sign), but will be recorded as
  1328.                    the key you typed. When you are ready, terminate
  1329.                    with CTRL-RETURN. THe macro is now ready to be
  1330.                    used.
  1331.  
  1332.                 If you want you may let a macro start another macro,
  1333.                 or even it self, but if you have a circular macro,
  1334.                 the only way to stop it is to press the
  1335.                 system-request button (on my keyboard it is ALTgr +
  1336.                 PrintScreen).
  1337.  
  1338.                 To exit from the macro-definition-screen, press ESC
  1339.                 (this will NOT undo the macros).
  1340.  
  1341.                 If you are not a registered user, the macro will
  1342.                 selfdestruct when you have used it three (3) times.
  1343.                 You may redefine it as many times you want or
  1344.                 perhaps register you copy of A3E.
  1345.  
  1346.  
  1347. FONT MENU
  1348.  
  1349.    Load Font    Every font must be in the directory with your
  1350.                 A3E.CFG-file. A list of available fonts will be
  1351.                 shown and you may choose any of them to use.
  1352.  
  1353.    Save Font    If you have loaded a font, the name of the loaded
  1354.                 font will be default, otherwise you will have to
  1355.                 enter a new name. The font will be saved in the same
  1356.                 directory as you A3E.CFG, and with the extension
  1357.                 .FNT
  1358.  
  1359.    View Font    A window with every ascii-character in the upper
  1360.                 part, and a copy of the current character (and the
  1361.                 two next to it) in the lower part will be shown.
  1362.                 Characters that have been defined will be white (in
  1363.                 the upper part) and otherwise they will be gray.
  1364.  
  1365.                 Walk around (with small the red square and look at
  1366.                 the defined characters. If you press return at any
  1367.                 character you will be able to modify the baseline of
  1368.                 that character (refer to the section on defining fonts)
  1369.  
  1370.                 Exit by pressing ESC (this will NOT undo any
  1371.                 changes).
  1372.  
  1373.    Margins      Horizontal margin sets how much space that should added
  1374.                 to the right of each character.
  1375.  
  1376.                 Vertical margin sets how many lines down the ENTER key
  1377.                 will make the cursor jump.
  1378.  
  1379.    Free Font    This command will free the memory that is occupied
  1380.                 by the current font and reset the fontname to nothing.
  1381.                 This feature will be useful when A3E supports the
  1382.                 feature to add screenpages online (which hopefully
  1383.                 will be available in the near future).
  1384.  
  1385.    Remove character
  1386.                 If you have a character in the font that is not
  1387.                 supposed to be there, simply delete it. The window
  1388.                 works like the one in View Font, except for when you
  1389.                 press return on a character, that character will be
  1390.                 deleted.
  1391.  
  1392.  
  1393.    Unregistered users may use fonts for evaluation purposes and when
  1394.    they do, the save feature will be disabled (they cannot save the
  1395.    screen with the fancy fonts). However, unregistered users may
  1396.    load, save and edit the fonts themselves unlimited.
  1397.  
  1398.  
  1399.  
  1400. PAGEMENU
  1401.  
  1402.    When A3E starts, there will only be one page to jump between, and
  1403.    if you want more pages you have to allocate them yourself.
  1404.  
  1405.    Allocate page   If you have enough memory you may allocate a page
  1406.                    with a customed size (max = 255 lines, min = 48
  1407.                    lines). The program will tell you which
  1408.                    pagenumber it has been allocated to and to get
  1409.                    there you press ALT-J from the editormode, and
  1410.                    enter the pagenumber). The default pagesize is
  1411.                    set by the config-switch DEFAULTLINESPERPAGE.
  1412.  
  1413.    Deallocate page If you are short of memory, and want to load a big
  1414.                    font, you might have to get rid of some large
  1415.                    pages. You may never deallocate the current page (the
  1416.                    one you currently work on).
  1417.  
  1418.  
  1419. CONFIGURATION
  1420.  
  1421. Configuration of A3E can be made in A3E.CFG, and so far the
  1422. following options are available, default in brackets:
  1423.  
  1424. Insert = ON/OFF                               [ON]
  1425.       Sets the default insertmode in the editor
  1426.  
  1427. Tabsize (+) = 0..9                            [3]
  1428.       Sets the default tabsize (changeable with ALT-T)
  1429.  
  1430. AnsiExt = EXT                                 [ANS]
  1431. AsciiExt = EXT                                [ASC]
  1432. AvatarExt = EXT                               [AVT]
  1433.       Consists of up to three characters (NO Point) and sets the
  1434.       default extension for each saveformat
  1435.  
  1436. SaveAnsi = ON/OFF                             [ON]
  1437. SaveAscii = ON/OFF                            [ON]
  1438. SaveAvatar = ON/OFF                           [OFF]
  1439.       Specify which formats to save as default
  1440.  
  1441. StatFG (+)       = ┐
  1442. StatBG (+)       = │
  1443. MenuFG (+)       = │
  1444. MenuBG (+)       = │        Black       Lightgray
  1445. MenuHIFG (+)     = │        Blue        Lightblue
  1446. MenuHIBG (+)     = │        Green       Lightgreen
  1447. CurrentFG (+)    = ├ one of Red         Lightred
  1448. CurrentBG (+)    = │        Cyan        Lightcyan
  1449. DefaultFG (+)    = │        Magenta     Lightmagenta
  1450. DefaultBG (+)    = │        Brown       Yellow
  1451. SubmenuFG (+)    = │        Darkgray    White
  1452. SubmenuBG (+)    = │
  1453. SubmenuHiFG (+)  = │
  1454. SubmenuHiBG (+)  = ┘
  1455.       Make your own color setup
  1456.  
  1457. SavePickList (+) = ON/OFF                     [OFF]
  1458.       Should the picklist be saved between each time ?
  1459.  
  1460. BBSConfigFileName =filename.ext               []
  1461.       The name (not path) of your BBSConfiguration file. This file
  1462.       must be kept in the same path as your main configuration, see
  1463.       further the BBSConfig.
  1464.  
  1465. DefaultCharSet = 0..9                         [0]
  1466.       Sets the default charset.
  1467.  
  1468. DefaultAnsiDir (+) = Drive:\Path              []
  1469.       If you have all your fancy files in a special directory
  1470.       (c:\ra\display for example) you can set the path here and A3E
  1471.       will start with your directory as defaultdir.
  1472.  
  1473. LoadMode = Ansi/Avatar/Ascii/Auto             [Auto]
  1474.       Sets the default Loadmode, see Filemenu-loadmode for further
  1475.       specifications. Auto recommendable.
  1476.  
  1477. MenuShortCuts = ALT/LRShift/Disabled          [ALT]
  1478.       Lets you make a shortcut to the top menu row (together with F10).
  1479.       ALT - "Tap" (that is press and release) the ALT button.
  1480.       LRShift - Tap the left and right shift at the same time.
  1481.       Disabled - No shortcut.
  1482.       This is mainly to avoid interference with for example
  1483.       DESQView which use the ALT-key to activate it's own menu.
  1484.  
  1485. ScreenBlankTime (+) = 0..255                  [5]
  1486.       Specify the number of minutes you want before the screen blanks.
  1487.       0 disables screenblanking completely.
  1488.  
  1489. MenuOn = ON/OFF                               [ON]
  1490.       If you want a display of the current characterset on the
  1491.       toprow, specify off.
  1492.  
  1493. ForceAsciiCR = ON/OFF                         [OFF]
  1494.       With Forceascii ON every line saved in asciimode will have a
  1495.       Carriage Return, and Linefeed in the end. If it is OFF, lines
  1496.       that are exactly 80 characters won't have these.
  1497.  
  1498. Ctrl-Y-Delline = ON/OFF                       [OFF]
  1499.       If you want CTRL-Y to be synonym to ALT-Y (an old and common
  1500.       standard) then specify this setting ON. Otherwise CTRL-Y will
  1501.       normaly return asciicharacter 25 (arrow down).
  1502.  
  1503. SortBBSCodes = ON/OFF                         [OFF]
  1504.       Makes it possible to sort your BBSCodes in an alphabetical
  1505.       order.
  1506.  
  1507. ExtraLines = 0..5                             [1]
  1508.       Specifies how many linefeeds to be added to the end of your
  1509.       files (can be individually changed).
  1510.  
  1511. ATKeyPad = ON/OFF                             [OFF]
  1512.       If you have an AT keypad (84 buttons), you can make sure that
  1513.       you can have the character sets on top of the keyboard, and
  1514.       have the cursor controls on the keypad. Make sure that Numlock
  1515.       is OFF.
  1516.  
  1517. WordStar = ON/OFF                             [OFF]
  1518.       Enables the classic wordstar commands for cursor movement.
  1519.       NB! Wordstar is disabled when you press scrollock and
  1520.       put the editor in "Allchars-mode". Wordstar is only available
  1521.       in editor-mode so far, not in paint-, or drawmode.
  1522.  
  1523. AdaptInDraw = ON/OFF                          [ON]
  1524.       (Adapt in draw) If you start DrawMode while having the cursor
  1525.       on a linecharacter, this switch will make drawmode default to
  1526.       the characterset containing that very character. Characters
  1527.       that appear in two different sets will give the lower one.
  1528.  
  1529. DefaultVGAEGA (+) = ON/OFF                    [OFF]
  1530.       Puts your screen in VGA/EGA-mode as default.
  1531.  
  1532. UseSwap (+) = ON/OFF                          [OFF]
  1533.       With UseSwap, you can enable swapping of A3E to EMS-memory,
  1534.       or disk (if you don't have enough EMS). This gives you an
  1535.       additional 200-300 k free memory in dosshell, on the other
  1536.       hand, swapping to disk takes a long time.
  1537.       If you find that swapping is too slow, just turn it off again.
  1538.  
  1539. InvertUnderCursor = ON/OFF                    [ON]
  1540.       A small feature that inverts the foreground intensity under
  1541.       the cursor to make the cursor visible even on "█" characters.
  1542.       It will slow down cursor movement about 15% on a fast
  1543.       keyboard. On a slow one you will not notice.
  1544.  
  1545. BlockMenuReturn = ON/OFF                      [ON]
  1546.       Do you want the block menu to return after each block command.
  1547.       If it is off you will be back in the editor after each
  1548.       command (even after view).
  1549.  
  1550. DefaultLinesPerPage (+) = 48..255             [48]
  1551.       When you allocate a new page, this value will be the
  1552.       defaultvalue of how big it shall be.
  1553.  
  1554. RemoveSolidSpacesPreSave = ON/OFF             [OFF]
  1555.       If you are having trouble with the solidspace (ascii 255) then
  1556.       you may want to strip it every time you save a file... Just
  1557.       turn this switch on.
  1558.  
  1559. DuplicateFileNamesInPickList = ON/OFF         [ON]
  1560.       If this switch is turned off a file name will only appear once
  1561.       in the picklist, otherwise it could appear several times with
  1562.       different paths and extensions.
  1563.  
  1564. DisableMorePromptInAnim = 0..255              [0]
  1565.       If you run a BBSprogram that will stop every now and then
  1566.       while viewing animations you may add a character in the
  1567.       beginning of the file to disable that feature (in Remote
  1568.       Access it is Chr( 5 ), so you would simply specify 5 here).
  1569.       Look in your BBS-manual if you are having problem.
  1570.  
  1571. ViewAnimationSlowDown = 0..255                [2]
  1572.       If you have a very fast (or a very slow) computer you propably
  1573.       wont like the default viewspeed of animations, therefor you
  1574.       can change this parameter (high numbers give a lot of
  1575.       slowdown). This will not effect the ansifile though, but only
  1576.       the internal viewfeature.
  1577.  
  1578. CompressAnimation = ON/OFF                    [ON]
  1579.       If you run a BBS you want your ansi/avatar files to be as
  1580.       small as possible, therefor you can strip every
  1581.       defaultcolored space in the animations (if you have a ClrScr
  1582.       in the file). This will screw up the animationloadsequence a
  1583.       bit, but not severely (defaultcolored spaces will be lost). If
  1584.       you want the complete animationsequence to be loaded, just
  1585.       turn off the compressionmode.
  1586.  
  1587. MarkMethod = 1..3                             [1]
  1588.       In animationmode the animated characters are shown by
  1589.       inverting colors or changeing the character temporarily. There
  1590.       are three ways of showing this and here you choose the default
  1591.       way of indicating that a character is animated.
  1592.  
  1593. MaxAnsiStringLength = 1..255                  [255]
  1594.       Some people have to limit the length of the strings in
  1595.       ansifiles. Here you can specify what lengths you want... For
  1596.       posting ansifiles to echoconferences, a maxlength of 70-75 is
  1597.       reccomended.
  1598.  
  1599. ClearScreen = CLEAR/HOME/NONE                 [CLEAR]
  1600.       In ansi/avatar files you can either have a clearscreen-code or
  1601.       a home-cursor-code in the beginning (or neither ofcourse). the
  1602.       difference between clearscreen and homecursor is that with
  1603.       homecursor the previous contents of the screen will be intact
  1604.       where the new screen has no information, with clearscreen, all
  1605.       previous information will be erased previous to drawing the
  1606.       new screen.
  1607.       Due to a lack in the specification ov avatar-codes, an
  1608.       avatarfile, with a home-cursorcode, that is longer than the
  1609.       screen will mess up heavily, just use the clearscreen instead.
  1610.  
  1611.  
  1612.  
  1613. All configuration (including BBSCodes) will be loaded from the
  1614. directory where you start your A3E.EXE, if you don't specify the
  1615. path in the environment variable A3E by putting something like this
  1616. in your AUTOEXEC.BAT:
  1617.    Set A3E=C:\A3E\CFG-DIR
  1618.  
  1619.  
  1620.  
  1621. A3ECONF.EXE, THE CONFIGURATION EASY-INSTALL UTILITY
  1622.  
  1623. If you dont like to edit configuration files in a texteditor, you
  1624. might use the "configuration easifyer", A3ECONF.EXE. Just put it in
  1625. the directory with your A3E.EXE and configurationfiles.
  1626.  
  1627. You will probably find it quite easy to use. Just enter the data as
  1628. you want it to be installed, switch pages with PgUp/PgDn and press
  1629. F10 to save it.
  1630.  
  1631. The configuration doesn't have much errorchecking yet, but on the
  1632. other hand, you can't misspell the commands, just the parameters.
  1633.  
  1634.  
  1635.  
  1636.  
  1637. BBSCONFIGURATION
  1638.  
  1639. One of the specialities of A3E is the special BBScodes (ALT - S),
  1640. but to make it work you have to have a special configuration file
  1641. for this. You specify the name of your BBScfg-file in A3E.CFG with
  1642. the option BBSCONFIGFILENAME and here is how it works.
  1643.  
  1644. Each BBSCode consists of one to two control characters, a
  1645. description and a length (length is optional and only used for the
  1646. Unfurl-BBSCodes-feature (see ALT - U). The rules for making the
  1647. configuration are rather strict, so please try to stick to them.
  1648. There is just about no errorhandling, so incase you do something wrong,
  1649. the most likely is for your computer to either hang in an endless
  1650. loop or get a runtimeerror. However, the configurationfiles included
  1651. in the archive have been tested and are known errorfree.
  1652.  
  1653. there are three different ways to set a code in the configfile:
  1654.  
  1655. with a ^-sign followed by an Upcase letter:
  1656.  ex: ^A   = asciicode 1
  1657.      ^S   = asciicode 19
  1658.  
  1659. with the numbersign (#) followed by a number between 0 and 255:
  1660.  ex: #4   = asciicode 4
  1661.      #65  = asciicode 65
  1662.  
  1663. with any single asciicharacter (except the ^ and the #):
  1664.  ex: S    = asciicode 83
  1665.      ┌    = asciicode 218
  1666.  
  1667. There can be a maximum of 2 asciicodes for each code, separated by a
  1668. space, and after the asciicodes comes an explanation of the code
  1669. surrounded by qoutationmarks ("). The length, if included, is
  1670. written as a plain number, between 1 and 80, and separated from the
  1671. closing qoute in the description by a space.
  1672.  
  1673. Here are a couple of sample codes:
  1674.  
  1675. ^S ^B "System Time" 8
  1676. ^F A "Users full name" 45
  1677. #6 #68 "Business/Data phone number" 10
  1678.  E "Voice/Home phone number" 10
  1679.  
  1680. If you are registered the 140 first codes in your configfile will be
  1681. loaded into memory, otherwise, the program will only load the first
  1682. 15. The explanations will be truncated to maximum 36 characters.
  1683.  
  1684. To make it possible to find anything in the list of ssopcodes you
  1685. can put a special keyword in the configurationfile, here is an
  1686. example:
  1687.  
  1688. Header "user statistics"
  1689.  
  1690. If you have a line like that it will be displayed upcased and in a
  1691. differing color, and will only be there for information (you will
  1692. not be able to choose it). You can also make it appear as the first
  1693. entry in a column by adding a number 1 after it:
  1694.  
  1695. Header "user statistics" 1
  1696.  
  1697. However if you use this you will decrease the number of codes that
  1698. will fit memory, the choice is yours...
  1699.  
  1700.  
  1701. There are default configurations for 3 different BBSes:
  1702.  
  1703. Remote Access (1.11)  - RA111.CFG
  1704.               (1.01)  - RA101.CFG
  1705. Wildcat       (2.50)  - WC250.CFG
  1706. PCExpress     (?)     - PCEX.CFG
  1707.  
  1708. NOTE! Some of the codes for RA110 have a special syntax, look at the
  1709. comments in the config or rather in RA's documentation.
  1710.  
  1711. If you have a BBS that is not covered by the configurations I've
  1712. made, please feel free to make your own. If you think they might be
  1713. of use to anyone else, send them to me and I'll distribute them with
  1714. the A3E-package.
  1715.  
  1716. There is an option in the normal config that makes it possible to
  1717. sort the BBScodes in an alphabetical order. This might work in your
  1718. setup, and it might not. I've found the case with RA111 that has one
  1719. code that is ^K and a lot of codes that starts with ^K and then has
  1720. another character to follow. If this is the case and the first
  1721. mentioned code is checked before the later, the others will never be
  1722. recognized, no matter what, when you do a BBSCodes identify (my tip
  1723. is to put all codes with just one character in the end of you
  1724. BBS-config and skip the sorting).
  1725.  
  1726. If you are using the Header-feature, sorting the BBScodes will
  1727. really screw things up!
  1728.  
  1729. If you want the information that is displayed with a BBS-code to be
  1730. at an absolute position (having 2 BBS-codes of variable length on
  1731. the same row might screw things up...) you could make use of
  1732. animations, as it will move the cursor to the right position before
  1733. writing to the screen (modem).
  1734.  
  1735. A user in holland pointed out that when he used a bunch of BBScodes
  1736. for pause (^w) in his logoutscreen they were compressed in the
  1737. avatar file and his BBS-program wouldn't understand them as
  1738. pausecharacters. The solution is to put a space in between each
  1739. pausecharacter to suppress compression ("^w^w^w" -> "^w ^w ^w")
  1740.  
  1741.  
  1742.  
  1743. PLANS FOR FUTURE VERSIONS
  1744.  
  1745. ■  Mouse support (I now have an IO-board, but still no compatible
  1746.    mouse :-( )
  1747.  
  1748. As long as there is any interest in new features and enhancements of
  1749. this program (from you or from me) I will keep spending my time
  1750. makeing it a better peice of software (instead of paying attention
  1751. to schoolwork and other important stuff :-).
  1752.  
  1753.  
  1754.  
  1755. THE END
  1756.  
  1757. If you have any suggestions for features you would like to see in
  1758. A3E, I'd be happy to hear it (there are no obvoius shortcuts left,
  1759. but I'll be able to squeeze it in somewhere I guess...) I'm also
  1760. very happy for bug reports (I want this to be a bug-free program
  1761. before the end of this century :-).
  1762.  
  1763. Contact me in any of these ways:
  1764.  
  1765.                    Jonas Högström
  1766.  
  1767.         Address..: Kungsbergsgatan 8c
  1768.                    S-582 53  LINKÖPING
  1769.                       S W E D E N
  1770.  
  1771.         Tel......: +46-13-122636
  1772.         Fax......: +46-21-350524 (might take a few days extra as it
  1773.                                   belongs to my parents.)
  1774.         BBS......: +46-33-201819 (talk to the sysop, my brother)
  1775.         FIDO.....: 2:204/408.3
  1776.         InterNet.: c91jonho@und.ida.liu.se
  1777.  
  1778.  
  1779.  
  1780. OFFICIAL DISTRIBUTION SITES
  1781.  
  1782. From the distributionsites you can always FREQ or DL the latest release of
  1783. A3E. FREQ with the magic filename A3E. Some of the Distributionsites
  1784. also carries the echoconference A3E_HELP (mainly sweden yet), where
  1785. you can post your questions about the editor and they will be
  1786. answered by me and the betateam.
  1787.  
  1788. Most sites support magic filename A3E for the latest official
  1789. release and A3E_BETA for the latest betaversion (supported by Mayday
  1790. & The Cross atleast).
  1791.  
  1792. Registered users can run betaversions (key-file needed), and they
  1793. can be FREQed from either MayDay BBS, The Cross or Gunship
  1794. (A3E_nnnB.ZIP).
  1795.  
  1796. Main Distributionsite:
  1797.  
  1798. BBS.......: MayDay BBS
  1799. Sysop.....: Jesper Högström
  1800. NodeNumber: 2:203/417
  1801. TelNumber.: +46-33-100 747 (1200-14400 DL & FREQ)
  1802. FREQ......: Anyone
  1803.  
  1804.  
  1805. Local distributionsites:
  1806.  
  1807.      Sweden
  1808.  
  1809. BBS.......: The Cross
  1810. Sysop.....: Jan Boström
  1811. NodeNumber: 2:204/408
  1812. TelNumber.: +46-13-124653 (1200-14400 DL & FREQ)
  1813. FREQ......: Anyone
  1814.  
  1815.  
  1816. BBS.......: Gunship BBS
  1817. Sysop.....: Fredrik Lewerth
  1818. NodeNumber: 2:203/117
  1819. TelNumber.: +46-31-693306 (1200-14400 DL & FREQ)
  1820. FREQ......: Anyone
  1821.  
  1822.  
  1823. BBS.......: Braxen BBS
  1824. Sysop.....: Per Brax
  1825. NodeNumber: 2:200/409
  1826. TelNumber.: +46-46-712396 (1200-14400 DL & FREQ)
  1827. FREQ......: Anyone
  1828.  
  1829.  
  1830.      Holland
  1831.  
  1832. BBS.......: HCC DataCom GG
  1833. Sysop.....: Gerard ter Haar
  1834. Nodenumber: 2:500/137
  1835. TelNumber.: +31-3449-1909 (1200-14400 DL & FREQ)
  1836. FREQ......: Anyone, any time
  1837. BBShours..: 08.00-01.00 local time
  1838.  
  1839.      USA
  1840.  
  1841. BBS.......: The Developers Network
  1842. Sysop.....: Chris Patterson
  1843. Nodenumber: 1:170/900
  1844. TelNumber.: +1-918-251-6252 (2400-14400 DL & FREQ)
  1845. TelNumber.: +1-918-251-1033 (2400-9600 DL ONLY!)
  1846. FREQ......: ANYONE
  1847. Adress....: P.O. Box 1660
  1848.             Broken Arrow, OK 74013 1660
  1849.             USA
  1850.  
  1851.      Germany
  1852.  
  1853. BBS.......: Granny's Inn
  1854. Sysop.....: Peter Hampf
  1855. Nodenumber: 2:240/11
  1856. TelNumber.: +49-4441-5404 (2400-14400 DL & FREQ)
  1857. FREQ......: ANYONE
  1858. Adress....: Peter Hampf
  1859.             Graf von Galen Strasse 27
  1860.             W 2848 Vechta
  1861.             Germany
  1862.  
  1863.  
  1864.  
  1865. A3E 1.00 was hatched through the SDS fileecho, and this will
  1866. hopefully be done in the future as well, so before you go calling an
  1867. international call, look at your local SDS-site.
  1868.  
  1869. A3E has also been uploaded at SIMTEL, the _big_ FTPsite in USA, and
  1870. this will hopefully also be done in the future. The full adress to
  1871. SIMTEL is: wsmr-simtel20.army.mil
  1872. So if you have FTPaccess you could look there (or any full or
  1873. partial SIMTEL-mirror (in Europe you could try nic.funet.fi)) for
  1874. new versions of A3E.
  1875.  
  1876.  
  1877.  
  1878. ------------------------------------------------------------------------
  1879. REGISTRATION FORM (also as Register.FRM in the A3E archive)
  1880.  
  1881. Name:_______________________________________________________
  1882.  
  1883. Company:____________________________________________________
  1884.  
  1885. Address:____________________________________________________
  1886.  
  1887. ZIP and city:_______________________________________________
  1888.  
  1889. State/country:______________________________________________
  1890.  
  1891. Telephone:__________________________________________________
  1892.  
  1893. Tick the way you would like your A3E.KEY:
  1894. ____ Fileattach (FIDO)(TO:______________________________)
  1895. ____ UUencoded E-mail (TO:______________________________)
  1896. ____ Snailmail to the adress above.
  1897.  
  1898. If you are a sysop what's the name, phone number, nodenumber
  1899. and software of your BBS:
  1900. ____________________________________________________________
  1901.  
  1902. Where did you get hold of A3E:
  1903. __ a friend
  1904. __ a BBS (give me phone or nodenumber:______________________)
  1905. __ uploaded to my own BBS
  1906. __ FTP (please enter site:__________________________________)
  1907. __ a shareware distributor:_________________________________
  1908. __ somewhere else:__________________________________________
  1909.  
  1910.  
  1911. What version of A3E Do you have right now:__________________
  1912.  
  1913. IF you want info on future updates, please state either a
  1914. FIDO nodenumber or an INTERNET-address:_____________________
  1915.  
  1916. My suggestions on how to improve A3E:_______________________
  1917.  
  1918. ____________________________________________________________
  1919.  
  1920. ____________________________________________________________
  1921.  
  1922. ____________________________________________________________
  1923.  
  1924. If you find any of the questions above violating your
  1925. personal integrity, you are free to refuse answering them
  1926. (does not include your address and wanted disksize), I'm
  1927. just kind of curious about the ways that A3E travel...
  1928.  
  1929.  
  1930. PS,
  1931.    Registrationfee and adresses where to send all this is
  1932.    stated in the section about registration.             DS.
  1933. ------------------------------------------------------------
  1934.  
  1935. <-- End of A3E.DOC -->
  1936.